/*
    * Copyright (C) 2008 The Guava Authors
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    * http://www.apache.org/licenses/LICENSE-2.0
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package com.google.common.collect.testing;
  
  import com.google.common.annotations.GwtCompatible;
  
  import java.util.List;
  import java.util.Map;
  import java.util.Map.Entry;
  
  /**
   * Implementation helper for {@link TestMapGenerator} for use with maps of
   * strings.
   *
   * @author Chris Povirk
   * @author Jared Levy
   * @author George van den Driessche
   */
  @GwtCompatible
  public abstract class TestStringMapGenerator
      implements TestMapGenerator<String, String> {
  
    @Override
    public SampleElements<Map.Entry<String, String>> samples() {
      return new SampleElements<Map.Entry<String, String>>(
          Helpers.mapEntry("one", "January"),
          Helpers.mapEntry("two", "February"),
          Helpers.mapEntry("three", "March"),
          Helpers.mapEntry("four", "April"),
          Helpers.mapEntry("five", "May")
      );
    }
  
    @Override
    public Map<String, String> create(Object... entries) {
      @SuppressWarnings("unchecked")
      Entry<String, String>[] array = new Entry[entries.length];
      int i = 0;
      for (Object o : entries) {
        @SuppressWarnings("unchecked")
        Entry<String, String> e = (Entry<String, String>) o;
        array[i++] = e;
      }
      return create(array);
    }
  
    protected abstract Map<String, String> create(
        Entry<String, String>[] entries);
  
    @Override
    @SuppressWarnings("unchecked")
    public final Entry<String, String>[] createArray(int length) {
      return new Entry[length];
    }
  
    @Override
    public final String[] createKeyArray(int length) {
      return new String[length];
    }
  
    @Override
    public final String[] createValueArray(int length) {
      return new String[length];
    }
  
    /** Returns the original element list, unchanged. */
    @Override
    public Iterable<Entry<String, String>> order(
        List<Entry<String, String>> insertionOrder) {
      return insertionOrder;
    }
  }